.TH std::fputwc 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::fputwc \- std::fputwc

.SH Synopsis
   Defined in header <cwchar>
   std::wint_t fputwc( wchar_t ch, std::FILE* stream ); \fB(1)\fP
   std::wint_t putwc( wchar_t ch, std::FILE* stream );  \fB(2)\fP

   Writes a wide character ch to the given output stream stream.

   2) May be implemented as a macro and may evaluate stream more than once.

.SH Parameters

   ch     - wide character to be written
   stream - the output stream

.SH Return value

   ch on success, WEOF on failure. If an encoding error occurs, errno is set to EILSEQ.

.SH Example


// Run this code

 #include <cerrno>
 #include <clocale>
 #include <cstdio>
 #include <cstdlib>
 #include <cwchar>
 #include <initializer_list>

 int main()
 {
     std::setlocale(LC_ALL, "en_US.utf8");

     for (const wchar_t ch :
     {
         L'\\u2200', // Unicode name: "FOR ALL"
         L'\\n',
         L'∀',
     })
     {
         if (errno = 0; std::fputwc(ch, stdout) == WEOF)
         {
             std::puts(errno == EILSEQ
                 ? "Encoding error in fputwc"
                 : "I/O error in fputwc"
             );
             return EXIT_FAILURE;
         }
     }
     return EXIT_SUCCESS;
 }

.SH Possible output:

 ∀
 ∀

.SH See also

   fputc  writes a character to a file stream
   putc   \fI(function)\fP
   fputws writes a wide string to a file stream
          \fI(function)\fP
   fgetwc gets a wide character from a file stream
   getwc  \fI(function)\fP
   C documentation for
   fputwc
